home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / u_man / cat1 / pmdaxvm.z / pmdaxvm
Encoding:
Text File  |  2002-10-03  |  5.1 KB  |  133 lines
  1.  
  2.  
  3.  
  4. PPPPMMMMDDDDAAAAXXXXVVVVMMMM((((1111))))                                                          PPPPMMMMDDDDAAAAXXXXVVVVMMMM((((1111))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      ppppmmmmddddaaaaxxxxvvvvmmmm - XVM performance metrics domain agent
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      ////vvvvaaaarrrr////ppppccccpppp////ppppmmmmddddaaaassss////xxxxvvvvmmmm////ppppmmmmddddaaaaxxxxvvvvmmmm [----dddd _d_o_m_a_i_n] [----llll _l_o_g_f_i_l_e]
  13.  
  14. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  15.      ppppmmmmddddaaaaxxxxvvvvmmmm is a Performance Metrics Domain Agent (PMDA) which exports XVM
  16.      volume element and physical volume performance metrics (IO operations per
  17.      second and throughput), as well as other metrics specific to each of the
  18.      striped, mirrored, and concatenated volume types.
  19.  
  20.      A brief description of the ppppmmmmddddaaaaxxxxvvvvmmmm command line options follows:
  21.  
  22.      ----dddd   It is absolutely crucial that the performance metrics _d_o_m_a_i_n number
  23.           specified here is unique and consistent.  That is, _d_o_m_a_i_n should be
  24.           different for every PMDA on the one host, and the same _d_o_m_a_i_n number
  25.           should be used for the same PMDA on all hosts.
  26.  
  27.      ----llll   By default a log file named _x_v_m._l_o_g is written in the directory
  28.           where ppppmmmmddddaaaaxxxxvvvvmmmm is started, i.e. since ppppmmmmccccdddd(1) makes /_v_a_r/_a_d_m/_p_c_p_l_o_g
  29.           (or $$$$PPPPCCCCPPPP____LLLLOOOOGGGGDDDDIIIIRRRR if set in the environment) its current directory,
  30.           the default logfile for ppppmmmmddddaaaaxxxxvvvvmmmm is ${_P_C_P__L_O_G_D_I_R-
  31.           /_v_a_r/_a_d_m/_p_c_p_l_o_g}/_x_v_m._l_o_g.  If the log file cannot be created or is
  32.           not writable, output is written to standard error instead.
  33.  
  34.           The ----llll option specifies an alternative name for the log file.
  35.  
  36. IIIINNNNSSSSTTTTAAAALLLLLLLLAAAATTTTIIIIOOOONNNN
  37.      In order for a host to export the names, help text and values for the xvm
  38.      performance metrics, do the following as root:
  39.  
  40.           # cd /usr/pcp/pmdas/xvm
  41.           # ./Install
  42.  
  43.      If you want to undo the installation, do the following as root:
  44.  
  45.           # cd /usr/pcp/pmdas/xvm
  46.           # ./Remove
  47.  
  48.      ppppmmmmddddaaaaxxxxvvvvmmmm is launched by ppppmmmmccccdddd(1) and should never be executed directly.
  49.      The Install and Remove scripts notify ppppmmmmccccdddd(1) when the agent is installed
  50.      or removed.
  51.  
  52. FFFFIIIILLLLEEEESSSS
  53.      ////eeeettttcccc////ppppmmmmccccdddd....ccccoooonnnnffff
  54.                command line options used to launch ppppmmmmddddaaaaxxxxvvvvmmmm
  55.      ////vvvvaaaarrrr////ppppccccpppp////ppppmmmmddddaaaassss////xxxxvvvvmmmm////hhhheeeellllpppp
  56.                default help text file for the xvm metrics
  57.      ////vvvvaaaarrrr////ppppccccpppp////ppppmmmmddddaaaassss////xxxxvvvvmmmm////IIIInnnnssssttttaaaallllllll
  58.                installation script for the ppppmmmmddddaaaaxxxxvvvvmmmm agent
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. PPPPMMMMDDDDAAAAXXXXVVVVMMMM((((1111))))                                                          PPPPMMMMDDDDAAAAXXXXVVVVMMMM((((1111))))
  71.  
  72.  
  73.  
  74.      ////uuuussssrrrr////ppppccccpppp////ppppmmmmddddaaaassss////xxxxvvvvmmmm////RRRReeeemmmmoooovvvveeee
  75.                undo installation script for ppppmmmmddddaaaaxxxxvvvvmmmm
  76.      $$$${{{{PPPPCCCCPPPP____LLLLOOOOGGGGDDDDIIIIRRRR----////vvvvaaaarrrr////aaaaddddmmmm////ppppccccpppplllloooogggg}}}}////xxxxvvvvmmmm....lllloooogggg
  77.                default log file for error messages and other information from
  78.                ppppmmmmddddaaaaxxxxvvvvmmmm
  79.  
  80. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  81.      PPPPCCCCPPPPIIIInnnnttttrrrroooo(1) and ppppmmmmccccdddd(1).
  82.  
  83.      If the Performance Co-Pilot product (Version 2.1 or later) is installed,
  84.      then the following entry is also relevant:
  85.      ppppmmmmggggxxxxvvvvmmmm(1).
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.